home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / Pascal / Applications / Balloon Help Tool / BP Text Maker Doc - Read Me! < prev    next >
Encoding:
Text File  |  1996-06-10  |  3.7 KB  |  68 lines  |  [TEXT/ttxt]

  1. Make Balloon Compiler Text
  2.  
  3. works in conjunction with the Peter M Lewis's excellent Balloon Help Compiler for Code Warrior. It's something I whipped up using Code Warrior's 9 Pascal compiler to take all the menus and dialogs in a resedit (rsrc) or Application and spit them out in a CW text file in the same format as Peter's Ballon Help Compiler requires. It's a simple 68K application and there won't be a fat version cause it's not worth writing (like 10 seconds vs 2 seconds to rip through an application with 42 menus and about 200 dialogs).
  4.  
  5. This is a FreeWare Application and may be freely distributed and used. I would ask that if you use this, have a look through your hard drive and see what shareware applications your using and make sure you've paid the author for their efforts.
  6.  
  7. I accept no reponsibility if it crashes, eats, destroys things or otherwise raises havoc on your mac. Testing has been limited to my own PowerMac under system 7.5.3 , so use it at your own risk. If you wish to get in touch with me, send E-Mail to Milton Aupperle at aupperlm@cadvision.com.
  8.  
  9. To use it do the following:
  10. 1) double click on the Make Balloon Text application
  11. 2) When the Open File dialog appears select the Application or Resedit RSRC file you want to process
  12. 3) Click open
  13. If any of your dialogs are set up to automautically "show" themselves, they will briefly "flash" onto the monitor and then disapear. Although visually unappealing, it doesn't hurt anything and is more work than it's worth to trap out.
  14. 4) After a few seconds, the application quits back to the desktop and your done.
  15.  
  16. The Make Balloon Text application does the following things for you:
  17.  
  18. 1) Creates a .bh text file with all the menus and dialog ditl items in it. The created text file will be named the same as the file you processing, with the letter .bh appended to it's name (ie if you process "myapp", the resulting file is called "myapp.bh"). NOTE that any file having the same .bh" name designation will be over written (ie a pre existing "myapp.bh" will be over written).
  19.  
  20. 2) it numbers the items based on your menu ID & dialog id and posts the resources name beside them
  21.  
  22. 3) It Keeps track of the state of the menu and ditl items and flags them appropriately into the 4 categories that Peter's compiler uses (x.1 = enabled x.2 = disabled x.3 checked x.4 other). Due to a few complexities, the only menus that will be designated as disabled (x.2) will be those that are a line separators in a menu and sub menus will show up as x.4.
  23.  
  24. 4) for ditl dialog items, it also indicates what type of ditl item each is and posts out the name of controls, buttons and text for static or editable text.Since some people may not want to know exactly what each item is, I made the flags for them fairly unique so you can do a find and replace to strip this stuff out if you need to, using the following text.
  25.  
  26. •utm• - a user defined item
  27. •btn• - button control - like "okay"
  28. •rbt•  - radio button control
  29. •cbx•  - checkbox control
  30. •cnt•  - resource control like scroll bars etc.
  31. •stt• -  static text
  32. •ett•  - edit text
  33. •icn•  -  icon
  34. •pic• -  picture
  35. •???•  - Unknown type - probably you'll never see this, but who knows.
  36.  
  37. The resulting file could look like this:
  38.  
  39. MENU 81 File menu
  40. 1.1 New Map…
  41. 2.1 Open…
  42. 3.2 Close…
  43. 4.1 Save
  44. 5.1 Save As…
  45. 6.3 Import
  46. 7.4 Export
  47. 8.2 -
  48. 9.1 Page Setup…
  49. 10.1 Print…
  50. 11.1 Print Rect Size…
  51. 12.2 -
  52. 13.1 Quit
  53. END-MENU
  54. DIALOG 592 Pict Dissemble options
  55. 1.1 •btn• Okay
  56. 2.1 •btn• Cancel
  57. 3.2 •utm• 
  58. 4.1 •utm• 
  59. 5.1 •cbx• Rubber Sheet (Requires ≥6 Tie points)
  60. 6.2 •stt• Tag:
  61. 7.3 •cbx• Keep This Object
  62. 8.1 •stt• Objects
  63. 9.1 •cbx• Adjust line weights for scaling
  64. 10.3 •cbx• Adjust Font Size for Scaling
  65. 11.2 •rbt• Don't Re-Shape Rectangles & Ovals
  66. END-DIALOG
  67. END
  68.